Overblik

Dette afsnit beskriver de tilgængelige REST-endpoints til hentning af oplysninger om tinglysningsobjekter.

Servicen leverer tre hovedfunktionaliteter: hentning af objektoplysninger via UUID eller alias, søgning efter objekter der er ændret inden for et datointerval, og søgning efter seneste ændringsdato for et specifikt objekt.

Endpoints

TinglysningsobjektByUuid

Endpoint URL: tinglysningsobjekter/uuid/{uuid}

Method

GET

Beskrivelse

Hent tinglysningsobjektoplysninger ved hjælp af dets UUID.

Input

Path parameter:

  • uuid

Output

JSON-svar indeholdende tinglysningsobjektoplysninger.

Fejlhåndtering

Standard HTTP fejlkoder ved ugyldigt input eller manglende adgang

Interaktionsmønster

Forespørgsel-svar

Eksempel på forespørgsel:

GET /tinglysningsobjekter/uuid/15963017-fb2b-417d-83d2-61442cde300f HTTP/1.1
host: nc-dev-xml-api.tinglysning.dk
accept: */*

TinglysningsobjektByAlias

Endpoint URL: tinglysningsobjekter/alias/{alias}

Method

GET

Beskrivelse

Hent tinglysningsobjektoplysninger ved hjælp af dets alias (dato-løbenummer format).

Input

Path parameter:

  • alias

Output

JSON-svar indeholdende tinglysningsobjektoplysninger.

Fejlhåndtering

Standard HTTP fejlkoder ved ugyldigt input eller manglende adgang

Interaktionsmønster

Forespørgsel-svar

Eksempel på forespørgsel:

GET /tinglysningsobjekter/alias/20221209-1000046002 HTTP/1.1
host: nc-dev-xml-api.tinglysning.dk
accept: */*

AendredeTinglysningsobjekter

Endpoint URL: tinglysningsobjekter/aendringer

Method

POST

Beskrivelse

Find tinglysningsobjekter der er blevet modificeret inden for et specificeret datointerval. Bruger POST-metode med JSON request body.

Input

JSON request body indeholdende søgekriterier (bog, datointerval, paginering).

Output

JSON-svar indeholdende en liste af modificerede objekter med deres ændringsdatoer.

Fejlhåndtering

  • Standard HTTP fejlkoder ved ugyldigt input eller manglende adgang

Interaktionsmønster

Forespørgsel-svar

Eksempel på forespørgsel:

POST /tinglysningsobjekter/aendringer HTTP/1.1
host: nc-dev-xml-api.tinglysning.dk
accept: */*
Content-Type: application/x-www-form-urlencoded

SenesteAendring

Endpoint URL: tinglysningsobjekter/senesteaendring

Method

POST

Beskrivelse

Find den seneste ændringsdato for et specifikt tinglysningsobjekt. Bruger POST-metode med JSON request body.

Input

JSON request body indeholdende objektidentifikator.

Output

JSON-svar indeholdende den seneste ændringsdato.

Fejlhåndtering

  • Standard HTTP fejlkoder ved ugyldigt input eller manglende adgang

Interaktionsmønster

Forespørgsel-svar

Eksempel på forespørgsel:

POST /tinglysningsobjekter/senesteaendring HTTP/1.1
host: nc-dev-xml-api.tinglysning.dk
accept: */*
Content-Type: application/x-www-form-urlencoded